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Limited Warranty on Media 

New Horizons Software warrants to the original purchaser that the media on 
which this computer program is recorded shall be free from defects in material or 
workmanship for a period of ninety (90) days from the date of purchase. 

This warranty shall not apply if the product has been damaged by accident, 
unreasonable use, or by other causes unrelated to defective materials or 
workmanship. 

This warranty gives you specific legal rights, you may also have other rights 
which vary from state to state. Some states do not allow limitations on how 
long an implied warranty lasts, and/or do not allow the exclusion of incidental or 
consequential damages, so the above limitations and exclusions may not apply 
to you. 

New Horizons Software designed this software for use on Atari® computers. 
With proper application, this program will perform as promised in the manual. 
New Horizons Software, however, is responsible for neither the particular 
application nor any problems resulting from that input 

We invite you to contact us with any questions, problems, or suggestions you 
may have concerning this product Please write to us at 

New Horizons Software, Inc. 

P.O. Box 43167 
Austin, TX 78745 

Or call us at (512) 280-0319 


Atari is a registered trademark of Atari, Coip. 
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Introduction 

Overview 

Genie, your wish is it’s command. An ideal tool for use with your Atari 
computer. With Genie you can stop right where you are in a program, execute 
any one of Genie's useful functions and then go back to exacdy where you left 
off, like magic. 

Genie does not interfere with your main program, and only appears when you 
summon it. Once installed, Genie will wait for your summons until you turn 
your computer off. 

Genie only works with Atari XL or XE computers that have at least 64K of 
memory, since it utilizes the 16K of memory that is hidden "under" the 
operating system. The only accessory you'll need is a disk drive and you're ready 
to put Genie to work. Note that Genie will not work with any programs that 
use the same 16K region of memory. This means that any program that requires 
the Atari Translator Disk will not work with Genie. 

Using This Manual 

Genie is designed for all users of Atari computers. Beginners and experts alike 
will find these tools very useful. If you want to get started right away using 
Genie, then read the section on "Using Genie." If you later want to find out 
more about the full capabilities of Genie, read the section entided "Genie 
Reference." 

Throughout this manual, all special keys will be in bold. For example, if you 
read 


"press the Shift, Control, and Esc keys..." 

we are talking about the keys labeled "Shift", "Control", and "Esc". 

While using Genie, you will find that the keys Option, Select, Start, and 
Help will perform special functions. What these functions are is always listed 
across the top part of your screen while you are using Genie. Also note that the 
Break key does nothing when you are using Genie. 

While using Genie's DOS functions, you may come across a disk or file related 
error. If this happens Genie will give you an error code; you can find the 
explanation of these codes, along with some suggested remedies, in the 
Appendix. 
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Using Genie 

Getting Started 


Before you begin using your Genie disk it is a good idea to make a copy of it, 
and then use that copy exclusively. If anything should happen to your copy, 
you will still have your original disk to fall back on. To make a copy of your 
disk, see your DOS II reference manual (under "Duplicating Data Disks", page 
37). 

You must install Genie before you start using any other program. To install 
Genie follow these steps: 

1. Make sure that your computer is OFF. 

2. Turn on your disk drive and wait for the red BUSY light to go out 

3. Insert your copy of Genie into your disk drive (with the label facing up 
and out). If you have more than one disk drive, then use drive number 
one. 

4. Turn ON your computer. 

5. After a few seconds you will see a copyright message on your screen. 
Genie is now loading. 

6. When Genie has finished loading, you will be asked to insert your 
program disk. Insert the disk you wish to use for your main 
application. 

7. Press the Select key. Your main program will start loading just as if 
Genie weren't there. Once your program finishes loading you are ready 
to start using your application, with Genie at your beck and call. 



Summoning Genie 


You can summon Genie at any time (except when your computer is using your 
disk drive or printer) by holding down the Shift and Control keys and pressing 
the Esc key. In the blink of an eye you will see the Genie Main Menu, from 
which you can choose one of it's options. Use this key sequence any time you 
wish to call up your Genie, it's the computer equivalent to rubbing a lamp. 

To leave Genie, simply press either the Help or Esc key. You will return to 
exacdy where you were before you summoned Genie. Note that in every Genie 
function except the Note Pad, the Help key and Esc key perform the same 
function of either cancelling an operation or returning to the Main Menu (or 
back to your program if you are already at the Main Menu). 
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The Genie Menu 


Once you have summoned your Genie, you will see a list of options that you 
can choose from: 



Leave GENIE 
Do Selection 




Move Up 
Move Down 


Copyright (cl 1985 
Hew Horizons Software 


GENIE 
Main Menu 


113 Mote Pad 


Zl Calculator 
33 AT ASCII Table 
43 DOS Functions 


Figure 1 

The Genie Main Menu 


To select a menu option, either use the Option and Select keys to move the 
highlighting bar up or down and press Start to make your selection, or simply 
press the number corresponding to your selection. 

You can also use the cursor up and down keys — either with or without pressing 
the Control key -- to move the highlighting bar up or down, and the Return 
key to make your selection. 

Finally, you can use the Atari Numerical Keypad (CX-85) number keys, or its 
cursor keys (located along the left hand side) and its +Enter key. 
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Making Your Wishes Come True 


Once you tell Genie your selection, you will be taken directly to that function. 
Genie’s four capabilities are briefly discussed below. For more complete 
information see the discussion of each function in the "Genie Reference" section. 

All of Genie's functions will work with the Atari Numerical Keypad, although 
the operation of the special keys may vary from one function to another. For 
information, see the discussion of the Numerical Keypad in the "Genie 
Reference" section. 

Genie Note Pad: No more hunting for scraps of paper to write something 
down on. With the Genie Note Pad you can type in whatever comes to mind 
whenever you want You can save your thoughts to a file for later retrieval (or 
for use by your regular word processor), or just print them when you are done. 

You can also load other small files into Genie's Note Pad, to either edit or print 
them. The capacity of Genie's Note Pad is about 120 screen lines, more than 
enough for most needs (but of course its not designed for writing the Great 
American Novel). 

The contents of your Note Pad will be saved until you turn your computer off. 
You can add a little now, go back to what you were doing, and then come back 
to finish it later. 

Genie Calculator: With the Genie Calculator you have a useful five 
function desk calculator. You can add, subtract, multiply, and divide numbers, 
and raise a number to the power of another. 

The Genie Calculator also has a memory, so you can save temporary results to 
be used later. The contents of the memory are always shown on the screen, and 
are saved until you turn off your computer. 

ATASC1I Table: This is an indispensable feature for all programmers from 
casual to professional. With this table of Atari ASCII (ATASCII) keyboard 
codes, you no longer have to hunt through the appendices of your manuals. The 
table shows the codes (in hexadecimal) corresponding to all non inverse-video 
Atari characters (including the graphics characters). 

This table can also come in handy when you need to know the character for a 
particular printer control code. If your manual lists a code in hexadecimal you 
can quickly look up the corresponding key. 
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DOS Functions: This function is like having a DOS menu instantly 
available, without taking up any memory space. With this function you can see 
a diskette's directory, display a file's contents, rename, lock, unlock, or delete a 
file, or format a diskette. 

You merely select the option you want from the DOS Functions menu, just like 
selecting from the Genie Main Menu. You will then be asked for any additional 
information Genie needs to carry out your command (such as the name of the file 
you want to delete, or the drive number for the diskette you want to format). 

Once you've made a selection, you can abort it simply by pressing any of the 
four special keys (Option, Select, Start, or Help) or by pressing the Esc 
key. 
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Genie Reference 


Once Genie is installed it occupies the 16K of memory that is hidden "under" the 
Operating System (OS) ROM’s (actually, for technical reasons, there is only 
14K of memory available). In addition, a small routine is placed in main 
memory in a location that is seldom used (the bottom of page 1) to summon 
Genie when the special key combination is pressed. Any program that uses 
either the 14K of memory under the OS ROMs or the main memory location 
used by Genie will not work with Genie. 

Also, since the main program always has the last say in terms of what the 
system will recognize, some programs (in particular, those that use their own 
keyboard interrupt routine) will not let you summon Genie. 

Since both Genie and the Note Pad text must fit in the 14K of memory 
available, a few "frills" (such as word wrap in the Note Pad, binary math in the 
Calculator, and so on) have not been included in the Genie functions. 
Remember that every extra frill reduces the size of the Note Pad text area. 
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Genie Note Pad 


This function allows you to enter and edit up to about 120 screen lines of notes. 
When you select this option for the first time, you will see the usual header 
lines on top and a blank Note Pad screen. The Note Pad with some text entered 
into it looks like this: 



Main Menu 
Print 


B; 


Load File 
Save File 


GENXE Note Pad 


This is a sample of the GENXE Note Pad.U 

ia 

You can type in over X8B screen lines of 
text 

You can save your work to a file, print 
it, or load another file to work on.L3 
13 

Your text will be saved in the Note Pad 
until you turn your conputer off.a 


Figure 2 

The Genie Note Pad 


The Note Pad starts out in lower case; to change to upper case press the Caps 
key, to return to lower case press the Caps key again. 

To enter text into the Note Pad, just type the characters you want. All characters 
will be placed at the location of the cursor (the white box), and both the character 
under the cursor and those to its right are moved over to make room. Pressing 
Return will start a new line (Return characters show up on the screen as inverse 
video Esc characters). If you try to enter more text than the Note Pad can hold 
you will hear a beep. 

Certain keys also let you perform editing functions. A description of these keys 
and what they do is given below (in some cases you must hold down either the 
Shift or Control key when you press the editing key, this is shown in the key 
name). 

Control Up, Down, Left, or Right: Holding the Control key down and 
pressing one of the cursor arrow keys will move the cursor in that direction. If 
you try to move out of the text screen, the text will scroll up or down and the 
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new line will be shown. In effect the screen is a "window" on your full text 
You cannot move the cursor past the end of your text. 

Back-Space: Removes the character that is just left of the cursor and moves 
the cursor, the character under the cursor, and the following text back by one 
space. 

Control Insert: Inserts one space at the cursor location and shifts the 
character under the cursor and the following text over (just like typing a space 
and then moving the cursor left). 

Control Delete: Removes the character under the cursor and moves 
everything on the right of the cursor over (just like moving the cursor left and 
pressing Back-Space). 

Shift Insert: Inserts a new line between the current line and the line above the 
current one. The cursor is placed at the beginning of the new line. 

Shift Delete: Removes the line the cursor is on and moves all lines below it 
up. The cursor is placed at the beginning of the line. 

If you want to include the actual character for an editing key in your text instead 
of performing their function (for example, if you wanted an up-arrow character in 
your text instead of actually moving the cursor up) just press the Esc key before 
pressing the editing key. 

To print your notes, first make sure that your printer is on (and your printer 
interface is on if you have one), then press Start. 

To save your notes for later press the Select key. To load the notes you have 
previously saved press the Option key. You will be asked for the name of the 
file you wish to save to, or load from. Type a name such as D:NOTES.TXT, 
and press the Return key (you can leave off the D: part if you want to use disk 
drive 1). 

If Genie encounters an error while printing, saving, or loading, you will see an 
error ID. Check the appendix of this manual for an explanation of these error 
ID's. 

To leave the Genie Note Pad and return to the Genie Main Menu, press the 
Help key. 
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Genie Calculator 


This function gives you all the capabilities of a desk calculator, with the added 
ability to do calculations in hexadecimal. When you first select this option you 
will see the Calculator screen with no entries, and initially set to decimal mode. 
The Calculator screen with some entries looks like this: 



Main Menu 
Clear nil 


OPTION 

SELECT 


Clear Entry 
Clear Menory 



1 

GENIE 

542 


Calculator 

Dec 447 + 



36 



MeHory 

1 Hex/Dec| 

0 

000 1 

□ 

| Sun | 

0 

0 

0 

El El El 


Minus| 

El 

EJ 

0 

000 

+ 

| Re 1 

0 

0 

0 

LlJLI 



Figure 3 

The Genie Calculator 


There are three display lines for numbers; the top one shows the current contents 
of memory, the second one shows any previous entry and the pending operation 
(addition in the example above), and the last one shows either your current entry 
or the result of a previous calculation. The second display line also shows what 
the Calculator's current mode is (Dec or Hex). 

The Calculator has five functions and a memory. The operations, and keys you 
must press to perform them, are addition (+), subtraction (-), multiplication (*), 
division (/), and raising to a power ( A ). To use the Calculator you just enter your 
first number, press the operation key that you want, enter your second number, 
and finally press the equal sign. 

In addition there are several keys that perform special functions. To select the 
function you want, press the key that is the first character in the name (as shown 
on the screen) of the function. For example, press the "S" key for the Memory 
"Sum" function. The Calculator will accept only defined keys from either the 
keyboard or numerical keypad (If you are using the keypad, see the section on 
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"Using The Numerical Keypad"). The function keys and what they do are as 
follows: 

Hex/Dec (H): Changes the calculator from decimal to hex or vice versa. Any 
pending operations are first performed, and both the current entry and contents of 
memory are converted to the new mode. Note that although in hex mode you 
can work with numbers up to 12 digits in size, the conversion works only on 
numbers that are in the range of 0 through 65535 (0 through FFFF hex). If a 
number is not in this range a beep will sound, the word "ERR" will be shown 
under the current mode, and the offending number will be set to 0. The keys A 
through F can only be used in hex mode (to enter hex numbers), and the ( A ) key 
cannot be used in hex mode. 

Sum (S): Adds the current number to the contents of memory and saves the 
result in memory. If there was a pending operation then it is performed first. 

Minus (M): Works like the "Sum" function, but subtracts the current number 
from the one in memory. 

Rcl (R): Recalls the number in memory and makes it the current entry. 

You can clear either the current entry, the contents of memory, or everything by 
pressing the Option, Select, or Start key. When you leave the Calculator 
only the Calculator mode and contents of memory are saved, everything else is 
lost. 

To leave the Genie Calculator and return to the Genie Main Menu, press either 
the Help or Esc key. 
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ATASCH Table 


This function shows the codes (in hexadecimal) corresponding to all non-inverse 
video Atari ASCII (ATASCII) characters. When you select this option the 
screen looks like this: 



To get the codes for the inverse video characters, just add 80 hex to the code for 
the non-inverse character. For example, the code for inverse "A” would be 41 + 
80 = Cl. You can use the Genie Calculator to do the addition. 

To leave the ATASCII Table and return to the Genie Main Menu, press any key. 
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DOS Functions 


There are seven options to choose from under this function, you select the 
function you want the same way you select items from the Genie Main Menu 
(see page 5). When you select this option the screen looks like this: 


HELPn 

Main Menu 

■OPTION 

TfiRTtl 

Do Selection 

ISELECT 


Move Up 
Move Down 


DOS Functions 


23 

33 

43 

53 

63 

73 


irec tor 


Disp1 ay File 
Rename File 
Lock File 
Unlock File 
Delete File 
Forwat Disk 


Figure 5 
DOS Functions 


When you select one of these options you will be asked for some additional 
information. You can cancel your selection at this point by pressing any of the 
special keys (Help, Start, Select, or Option) or the Esc key. If you cancel 
your selection you will be returned to the DOS Functions menu. 

To leave the DOS Functions menu and return to the Genie Main Menu, press 
either the Help or Esc key. 

In many of the DOS Functions you will be prompted for Device:Filename. 
"Device:" is the disk drive specifier and "Filename" is the actual file name 
(wildcard characters can be entered as part of the Filename). For example, at the 
prompt you might type in: 

D2:TEST.TXT 
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This refers to the file called TEST.TXT located on the disk in disk drive number 
2. Unless you specify otherwise, Genie assumes that you are referring to disk 
drive 1. Therefore, the entries: 


Dl:TEST.TXT D:TEST.TXT TEST.TXT 

all refer to the same file. 


You can also specify "wildcards" as part of your file name. See your DOS 
reference manual for a discussion of using wildcards in specifying a file name. 

If Genie encounters an error while trying to perform one of the DOS Functions, 
an error message will be displayed with an error ID. Refer to the appendix of 
this manual for an explanation of the ID's. 


The following sections discuss each of the DOS Functions options. For a 
complete description of DOS operations refer to your DOS reference manual. 

Directory 

Allows you to find what files your disks contain. When you select this option 
you will be asked for a Device:Filename: 



CANCEL 

CANCEL 


IOPTION! 

iselectI 


CANCEL 

CANCEL 


DOS Functions 


11) Director 


23 Display File 
3) Rename File 
43 Lock File 
53 Unlock File 
63 Delete File 
73 Format Disk 


Device:Filename 


Figure 6 

Entering Device and/or Filename Information for Directory 


Type in a device and filename and press Return. The screen will clear and a list 
of all of the files that match your entry will be shown. If the display is too long 
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for one screen you can press Control 1 to temporarily stop the display. Press 
Control 1 again to resume the display. To cancel the listing and return to the 
DOS Functions menu, press any special key or the Esc key. 

If you just type Return at the Device:Filename prompt, Genie will 
automatically display a list of all files that are on disk drive 1. To see the files 
in any other disk drive you must explicitly say so, for example see the names of 
all of the files in drive 2 you would type D2:*.* and press Return. 

Display File 

Allows you to display a file's contents on your screen. Like the directory 
option, you will be asked for a DevicerFilename for the file you wish to see. 
Type the name of the file and press Return. The screen will display the file, 
scrolling upward if it is too big for one screen. To stop the scrolling of the 
screen press Control 1, to restart the display press Control 1 again. To 
cancel the display and return to the DOS Functions menu, press any special key 
or the Esc key. 

Rename File 

Allows you to change the names of your files. When you select this option you 
will be asked for the Device and Filename of the file you wish to rename, and 
the Filename you want it changed to: 
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Type in the device and filename you would like to rename, followed by a comma 
and the new name you would like the file to have and press Return. For 
example, if you want to rename the file NOTES.TXT in drive 2 to 
LETTER.TXT, you would enter 

D2:NOTES.TXT,LETTER.TXT 

Remember, you are renaming a file from what it is to what you want it to be, 
and thebetween the two names is necessary. Also, since only the file's name 
is being changed, and not which drive it is in, you must not specify a device as 
part of the new name. 

Lock File 

Allows you to lock files for protection. A locked file cannot be modified or 
deleted until it is unlocked (a locked file will have an asterisk (*) next to its 
name in a directory listing). When you select this option you will be asked for 
the Device:Filename of the file or files you want locked. Type your entry and 
press Return. 

Unlock File 

Allows you to unlock files that you have previously locked. When you select 
this option you will be asked for the Device:Filename of the file or files you 
want unlocked. Type your entry and press Return. 

Delete File 

Allows you to delete (erase) files from your disk. When you select this option 
you will be asked for the Device:Filename of the file or files you want deleted. 
Type your entry and press Return. 

WARNING: Be very certain that you want to delete the specified file before 
you press the Return key. Deleted files cannot be recovered! 


16 



Format Disk 

Allows you to format disks. All disks must be formatted at least once in order 
to use them. When you select this option you will be asked for the number of 
the drive which contains the disk you wish to format: 



CANCEL 

CANCEL 


IOPTIONI 

IselectI 


CANCEL 

CANCEL 


DOS Functions 


l) Directory 
23 Display File 
33 Rename File 
43 Lock File 
53 Unlock File 
63 Delete File 


173 Format Disk 


| Drive 

Number: 2| 

1 Insert Disk f 

| Press 

space Bar| 


Figure 8 

Formatting a Diskette 


Type a number from 1 to 8 (the number 2 was typed in the above example). 
Make sure the correct disk is in the drive and press the space bar. The formatting 
will take several seconds to complete and cannot be cancelled once it has started. 

WARNING: Formatting a disk will erase all files that may be on the disk. Be 
sure you want to format the disk before you press the space bar. 
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Using The Numerical Keypad 


Genie will automatically work with Atari's Numerical Keypad (CX-85). To use 
the numerical keypad simply plug it into your computer's joystick port number 
two. 

Depending upon which Genie function you are using, there are two possible sets 
of keyboard keys the Numerical Keypad keys produce. The diagram on the left 
of Figure 9 shows the keyboard keys produced by all functions except the Genie 
Calculator, the diagram on the right shows the keys produced when using the 
calculator. 


0 000 

□ 

El BEE 1 

□ 

El 000 

R 

El EBB 


0 000 

E 

T 

U 

0 BEE 

+ 

□ nun 

R 

N 

0 IZD0 



Standard Keypad Keys Calculator Keypad Keys 

Figure 9 

The Numerical Keypad Keys 


When using the Genie Calculator, the right side of the calculator screen has a 
pictorial representation (just like in Figure 9) of the keys the keypad produces, 
so you don't have to memorize two different key layouts. 
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Appendix 

Error Message Codes 

From time to time you may encounter errors when using Genie's DOS or 

printing functions. When this happens (with one exception), Genie will give 

you an error code which identifies the problem. The possible errors are described 

below. 

Code Description 

(none) No IOCB's Available: All I/O Control Blocks are in use by 

your main program. Have your main program close some files or 
devices. 

82 Nonexistent Device: You have tried to access an undefined 

device (ie., a device not in the handler table). Check your VO 
command for the correct device, and that you have loaded and 
initialized the handler. 

8A Device Timeout: The device doesn't respond. Examine all 

connections to make sure they are secure. Make sure your disk 

drive is turned on and set for the correct drive number. Check your 
command for the correct drive number. 

8B Device NAK: Problems are located at the serial port or in the 

peripheral. This is a device specific error, so refer to the 
documentation for that device. 

8C Serial Frame Error: Information was lost from the peripheral 

to the computer. This is a very rare error, if it occurs more than 
once have your device or computer checked. For cassettes, try the 
recovery suggested in 8A. 

8E Serial Bus Overrun: Information was lost from the peripheral 

to the computer. This is a rare error, if it occurs more than once 
have your computer serviced. 

8F Checksum Error: Information was lost from the peripheral to 

the computer. There is no standard recovery procedure because it 
could be either a hardware or software problem. 

90 Device Done Error: You have attempted to write on a write- 

protected disk. 
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92 Function Not Implemented: The function was not 

implemented in the device handler. 

AO Drive Number Error: You have specified an incorrect drive 

number. See page 87 of your DOS n Reference Manual for 
information on using more than two drives. 

A1 Too Many OPEN Files: No sector buffer is available. Close 

some files from your main program. 

A2 Disk Full: No free sectors available. Use a disk which has 

some free sectors. 

A3 Unrecoverable System I/O Error: The DOS version on 

your disk may be damaged. 

A4 File Number Mismatch: The disk file may be damaged. 

Consult your local user's group to help you recover this file. 

A5 File Name Error: Your file specification has illegal characters 

in it. 

A7 File Locked: You have tried to access a locked file for purposes 

other than to read it Unlock the file and try again. 

A9 Directory Full: You have used all the space (64 file names) 

allotted for the disk's directory. 

AA File Not Found: You tried to access a file that doesn’t exist in 

the directory. Check the directory for the correct spelling. 

AD Bad Sectors at Format Time: The disk drive found bad 

sectors while formatting a diskette. Use another diskette because a 
diskette with bad sectors cannot be formatted. If this error occurs 
with more than one diskette, your disk drive may need repair. 
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